home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / conins14.zip / CONINS.DOC < prev    next >
Text File  |  1993-07-05  |  11KB  |  353 lines
  1.     │
  2.     │
  3.     │
  4.     │
  5.     │
  6.     │
  7.     │
  8.     │
  9.     │
  10.     │
  11.     │
  12.     │
  13.     │
  14.     │
  15.     │
  16.     │
  17.     │
  18.     │    CONINS v 1.04 (c) CONCEPT SYSTEMS 1993
  19.     │
  20.     │    Written by Paul Giraud.
  21.     │
  22.     │    DOCUMENTATION FILE
  23.     │
  24.     │
  25.     │
  26.     │
  27.     │
  28.     │
  29.     │
  30.     │
  31.     │
  32.     │
  33.     │
  34.     │
  35.     │
  36.     │
  37.     │
  38.  
  39.  
  40. For ordering information, see the file REGISTER.FRM.  included in this
  41. archive.
  42.  
  43.  
  44. First all the legal stuff:
  45.  
  46.  
  47. LICENSE AGREEMENT AND WARRANTY DISCLAIMER.
  48. ------------------------------------------
  49.  
  50. You should carefully read  the  following  terms and conditions before
  51. using this software.  Use of this software indicates  your  acceptance
  52. of  these terms and conditions.  If you do not agree with them, do not
  53. use the software.
  54.  
  55.  
  56. SHAREWARE VERSION.
  57. ------------------
  58.  
  59. You are hereby licensed to: use  the Shareware Version of the software
  60. for a 30 day evaluation period; make as many copies of  the  Shareware
  61. version  of  this  software  and documentation as you wish; give exact
  62. copies of the original Shareware version to anyone; and distribute the
  63. Shareware version of the software  and documentation in its unmodified
  64. form via electronic means.  There is no charge for any of the above.
  65.  
  66. You  are  specifically  prohibited  from   charging,   or   requesting
  67. donations, or any such copies, however made; and from distributing the
  68. software  and/or  documentation  with  other  products  (commercial or
  69. otherwise) without prior written permission, subject to the conditions
  70. in this license, without specific written permission.
  71.  
  72.  
  73. EVALUATION AND REGISTRATION
  74. ---------------------------
  75.  
  76. This is not  free  software.   This  license  allows  you  to use this
  77. software for evaluation purposes without charge for  a  period  of  30
  78. days.   If  you use this software after the 30 day evaluation period a
  79. registration fee of  R20.00/US$10  plus  $5  shipping  and handling is
  80. required.  Payments can be in South African Rands by Cheque or  Postal
  81. Order, or in US Dollars via  bank  draft  or by Credit Card, we accept
  82. VISA & Mastercard.
  83.  
  84. Send payment to:
  85.  
  86.         P GIRAUD
  87.         32 Burn Street
  88.         Waverley
  89.         Johannesburg
  90.         South Africa
  91.         2090
  92.  
  93. When  payment  is  received I will post a private message to you on my
  94. BBS - The  Concept  BBS,  with  the  registration  number  of your new
  95. purchase.
  96.  
  97.  
  98. CREDIT CARD REGISTRATIONS.
  99. --------------------------
  100.  
  101. I you wish to register by credit card please refer to the REGISTER.FRM
  102. document included in the archive
  103.  
  104. One registered copy of CONINS may be dedicated to a single  person  or
  105. BBS  system  who  uses  the  software on one or more computers or to a
  106. single workstation used by multiple people.
  107.  
  108. You may access the  registered  version  of  CONINS through a network,
  109. provided that you have obtained individual licenses for  the  software
  110. covering  all  workstations  that will access the software through the
  111. network.
  112.  
  113.  
  114. NON REGISTERED EVALUATION VERSION.
  115. ----------------------------------
  116.  
  117. Until this program is registered there are certain areas that will not
  118. be accessible.  In the case of CONINS only two features are crippled:
  119.  
  120.     The program will not utilize any TEMP path specification specified
  121.     in the configuration file.
  122.                
  123.     This program will only operate  on  TEN archives in each run until
  124.     registered.
  125.  
  126. The  program  will  also  display  UNREGISTERED  EVALUATION   in   the
  127. registration   space  on  the  main  screen.   registration  has  its'
  128. advantages ......
  129.  
  130.  
  131. DISCLAIMER OF WARRANTY.
  132. ----------------------
  133.  
  134. This software and the accompanying files  are sold "as is" and without
  135. warranties  as  to  performance  of  merchantability  or   any   other
  136. warranties whether expressed or implied.
  137.  
  138. Because  of  the various hardware and software environments into which
  139. CONINS may be used, no warranty of fitness for a particular purpose is
  140. offered.
  141.  
  142. Good data processing procedure dictates that any program be thoroughly
  143. tested with non-critical data  before  relying  on  it.  The user must
  144. assume the entire risk of using the program.   Any  liability  of  the
  145. seller will be limited exclusively to product replacement or refund of
  146. purchase price.
  147.  
  148. INTRODUCTION.
  149. -------------
  150.  
  151. CONINS  is  a tool for both users and Sysops alike that aids insertion
  152. of  FILE_ID.DIZ   descriptions   into   specified   archives,  from  a
  153. pre-defined BBS listing or text file description file.  Currently  the
  154. program  will  only add into .ZIP archives, but future plans include a
  155. version that will  insert  into  .ARJ  archives  as well.  The program
  156. features:
  157.  
  158. -   Twenty line FILE_ID.DIZ.
  159. -   Fast operation.
  160. -   Internal ZIP routines.
  161. -   Handles any size text list quickly.
  162. -   Easy local registration.
  163. -   Command line driven.
  164. -   Complete LOG File written.
  165. -    Configurable description column.
  166.  
  167.  
  168. PROGRAM REQUIREMENTS.
  169. ---------------------
  170.  
  171. The program requires the following:
  172.  
  173.     384 KB RAM 
  174.     PKZIP.EXE & PKUNZIP.EXE v 1.1, 1.93A, 2.04G
  175.  
  176.  
  177. INSTALLATION.
  178. -------------
  179.  
  180. The self extracting CONINS archive contains the following files :
  181.  
  182.     CONINS  .COM    - The CONINS executable file.
  183.     CONINS  .CFG    - Sample configuration file.
  184.     CONINS  .DOC    - The CONINS documentation.
  185.     CONINS  .HST    - CONINS Version history file
  186.     README  .1ST    - New Features not included in this document.
  187.     REGISTER.FRM    - Concept Systems Software registration form.
  188.     PRODUCTS.CON    - Concept Systems Software catalogue.
  189.     FILE_ID .DIZ    - Descrioption file.
  190.  
  191. Note that the archive should display -AV when extracting the files, if
  192. not the archive has been tampered with.  The latest version of  CONINS
  193. can be downloaded from my bulletin board -
  194.  
  195.     The Concept BBS
  196.     Phone : (011) 440-6246
  197.     Speed : 2400 - 38400
  198.     Hours : 24 hours.
  199.  
  200. All  the  Concept  Systems  software  is available in the Concept Soft
  201. Conference - Conference 10.
  202.  
  203. Installation is easy - if  you  have  a  utility directory you may use
  204. this directory otherwise create a directory for CONINS and  unzip  the
  205. archive into whichever directory you want.
  206.  
  207. Placing  the executable file into the DOS PATH will make CONINS easier
  208. to use.
  209.  
  210. The next thing to do is  create  or modify the CONINS.CFG file to suit
  211. your system.  Please note that the configuration file name  cannot  be
  212. changed  under  any  circumstances.   Also please note that the config
  213. need not  be  in  the  same  directory  as  the  executable,  but when
  214. executing CONINS the configuration file must be on the same  drive  as
  215. CONINS or the program will not work.
  216.  
  217. The  configuration file consists of six lines and ONLY THE FIRST SEVEN
  218. LINES of this file are read by the program.
  219.  
  220.  
  221. Line 1 :- Registration Name
  222. ---------------------------
  223.  
  224. If you have  registered  CONINS  the  name  that  you completed on the
  225. registration form should be inserted onto this line - EXACTLY  as  you
  226. entered it on the form.
  227.  
  228. If  not  registered  enter  your  name  on this line or leave the line
  229. blank.
  230.  
  231.  
  232. Line 2 :- Registration Number
  233. -----------------------------
  234.  
  235. After registering CONINS you  will receive a personalized registration
  236. number - enter this number on this line.  If  you  haven't  registered
  237. either leave the line blank or enter 0.
  238.  
  239.  
  240. Line 3 :- PKZIP.EXE Path
  241. ------------------------
  242.  
  243. Enter  the  path to PKZIP.EXE on this line - if left blank the program
  244. will not work.  CONINS will verify  that PKZIP exists at this location
  245. so please enter the correct path.
  246.  
  247.     eg : C:\ZIP
  248.          C:\ZIP\
  249.  
  250.  
  251. Line 4 :- PKZIP.EXE Version
  252. ---------------------------
  253.          
  254. Due to the fact that PKZIP v 1.1 behaves a little differently  to  the
  255. newer  version  2.x pf PKZIP this line distinguishes which version you
  256. are currently using.  If blank CONINS will default to version handling
  257. and if you are using PKZIP v 1.1 the screens WILL BE OVERWRITTEN.
  258.  
  259.     For PKZIP v 1.1 enter a 1
  260.         PKZIP v 2.x enter a 2
  261.  
  262.  
  263. Line 5 :- TEMP Path.         
  264. --------------------
  265.  
  266. If you have a RAM drive  or  fast  TEMP drive CONINS will utilize this
  267. drive for searches - enter the path to this drive.  If left blank  the
  268. program  will  use  the  DOS  default defined in the PC's environment.
  269. (Registered version only)
  270.  
  271.     eg D:\
  272.        E:\TEMP\ 
  273.  
  274.  
  275. Line 6 :- Log File Path.     
  276. ------------------------
  277.  
  278. Enter the path where you  want  CONINS  to maintain your LOG FILE.  If
  279. left blank the log file feature will be disabled.
  280.  
  281.     eg : C:\LOG
  282.          C:\LOG\
  283.  
  284.          
  285. Line 7 :- Log File Type.
  286. ------------------------
  287.  
  288. You have a choice of two type of LOG entries:
  289.  
  290. APPEND - append last action to end of existing log file
  291. OVER   - overwrite the last log with current session info
  292.  
  293.  
  294. Line 8 :- Description Column Start.
  295. -----------------------------------
  296.  
  297. This item configures the column where CONINS will start looking for the
  298. description, from which to build the DIZ. An example follows:
  299.  
  300. PCBoard Format:
  301.  
  302.          1           2         3           4         5           6
  303. 1234567890123456789012345678901234567890123456789012345678901234567890
  304. TEST.ZIP     xxxxxxxx    xxxxx | This is where the description starts
  305.                                  │
  306. The starting column    ──────────┘ 
  307. of the description.
  308. Column 34.
  309.  
  310.  
  311. USING CONINS.
  312. -------------
  313.  
  314. Using the program is simple:
  315.  
  316. 1. Change to the directory where your archives are located.
  317.  
  318. 2. On the command line type:
  319.  
  320.     CONINS [Drive:\Path\Name to text file containing descriptions.]
  321.     
  322. eg  CONINS C:\LIST\PCBLIST.TXT
  323.  
  324.    Press enter and off you go - it's that simple.  When  complete  you
  325.    may  review  the log file for insertions etc and which files in the
  326.    directory do not have FILE_ID.DIZ descriptions as yet.
  327.  
  328. Please note as I mentioned earlier  ensure that the CONINS.CFG file on
  329. the same drive that CONINS is executed from or the  program  will  not
  330. work and will report an error.
  331.  
  332. CONINS v 1.02 is  designed  primarily  to  read  PCBoard  format  file
  333. listings  ie  -  the description line starts at COLUMN 34 of the list.
  334. If there are requirements for other  types of listings to be supported
  335. by CONINS I would be pleased to include them in the program  design  -
  336. contact me and let me know - I'll make a plan ....
  337.  
  338.  
  339. SUPPORT.
  340. --------
  341.  
  342. Should you wish to  comments  or  make recommendations, Please leave a
  343. message on the above mentioned board, I will answer any mail  left  on
  344. the  board - and will certainly entertain an new ideas for the program
  345. should there be any.  Mail should  be  address to either SYSOP or PAUL
  346. GIRAUD when left on the BBS.
  347.  
  348. A plea to all users - please  read the DOCS before using CONINS I have
  349. been inundated with calls from users that say that CONINS doesn't work
  350. and  only  to  find  that  when  following  th  correct   installation
  351. procedures the program works fine.
  352.  
  353.